home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Ascii-Ansi / Iff->Ascii-V1,4.LHA / ilbm2ascii-1.4 / ilbm2ascii.readme < prev    next >
Encoding:
Text File  |  1994-06-21  |  4.5 KB  |  71 lines
  1.  
  2. ILBM2ASCII                                                 @@@@@@@@@@@@@[
  3. ----------                                                 ~~~~~~~~~~~~~`
  4.  
  5. by Tobias Ferber                                           mmmmmmmmmmmmmi
  6. based on iff2ascii.amos by Matthew Stratfold               @A***********!
  7.                                                            @[
  8.                                                            @[
  9. What's it do?                                              @[
  10. -------------                                              @[
  11. It converts IFF pictures into an ASCII representation.
  12. The program will antialiase the text by selecting the      mmmmmmmmmmmmmi
  13. best characters to make the edge.  Characters are also     @A****M@****@[
  14. selected for their density when shading.                   @[    ]@    @[
  15.                                                            @[    ]@    @[
  16. How to use it:                                             @[    ]@    @[
  17. -------------                                              Y@_  _@@W__W@`
  18. The program can be invoked from the shell in the normal    'M@@@@A~*@@A`
  19. way or by running the arexx script use either:               '~~`
  20.  
  21. ilbm2ascii [ilbm-file] > [ascii file]
  22. rx ILBM2ASCII.rexx FROM [ilbm file] TO [ascii file]
  23.                                                            @@@@@@@@@@@@@[
  24. If you have ARexx running you can double click the icon    ~~~~~~~~~XX@@[
  25. and start it from the Workbench and select the picture         __mW@A*~`
  26. and destination file using file requesters.                _mW@A*~`
  27.                                                            @@b_.
  28. How it works:                                               ~V*@@ms_.
  29. ------------                                                    '~V*@@ms.
  30. The program looks at pixel blocks of 2x3 pixels and        mmmmmmmmmmW@@[
  31. selects a character that best matches that block.          *************!
  32. Consequently the ASCII picture will be much bigger and
  33. and a differnt aspect ratio than the original IFF.         @@m_    ims.
  34. You may want to adjust your IFF before conversion to       @PV@W.  !*M@b
  35. compensate for this.  If you want to know more then have   @[ '@W.    V@[
  36. a look at the source that's included.                      @[  '@W.    @[
  37.                                                            @[   !@@s__W@`
  38. Preparation of the pictures:                               @[    '*@@@*`
  39. ---------------------------                                s_
  40. The program assumes that any non background colour is      M@@Ws_
  41. a colour.  For this reason you should use 2 colour           ~V@@@Wm_
  42. images.  If you want to convert images with more colours       @['~*@@Wm.
  43. then load them in to your favourite imgage processor           @[   _d@@[
  44. and dither a 2 colour image from that.  ILBM2ASCII will        @bmW@@*f~
  45. select a character whose density best matches the dither.   ,_m@@@*f~
  46.                                                            @@*f`
  47.                                                            `
  48. Distribution etc:                                           gW@[  ,gmms.
  49. ----------------                                           d@*~` ,@@**@@.
  50. The Conversion Table is inspired by Jorn Barger's         i@!    d@!   MW
  51. alt.ascii art FAQ which had the table by Rob Harley in    ]@     @@    ]@
  52. it.                                                       !@.   ]@[   ,WP
  53.                                                            MWs_g@A  im@A`
  54. The program is freely distributable, though keep the        VM@@*`  !*~
  55. archive together and give credit where it's due.
  56.                                                              _mm@@@Wms.
  57. Feel free to include this any archives and libraries       ,W@**~~~V*@@s
  58. do not charge any money other than an amount to cover      @A`        V@i
  59. media, duplication and distribution.                      ]@`          Y@
  60.                                                           ]@           ]@
  61. All programming by Tobias Ferber.                         '@b         ,@P
  62. (ukjg@rz.uni-karlsruhe.de)                                 !@Wm_    ,g@A`
  63.                                                             'VM@    ]Af
  64. ILBM2ASCII is a C coded FAST program based on IFF2ASCII
  65. which was an AMOS program by Matthew Stratfold. Who also   mmmmmmmmmmmmmi
  66. helped out on this doc, examples and the-rat icon.         *************!
  67.  
  68.                                                            _____________.
  69.                                                            @@@@@@@@@@@@@[
  70.  
  71. This program is BeerWare - if you like it go and buy yourself a beer :-)